home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat4 / pkginfo.z / pkginfo
Encoding:
Text File  |  1998-10-20  |  11.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ppppkkkkggggiiiinnnnffffoooo((((4444))))                                                          ppppkkkkggggiiiinnnnffffoooo((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_kkkk_gggg_iiii_nnnn_ffff_oooo - package characteristics file
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      _pppp_kkkk_gggg_iiii_nnnn_ffff_oooo is an ASCII file that describes the characteristics of the
  13.      package along with information that helps control the flow of
  14.      installation.  It is created by the software package developer.
  15.  
  16.      Each entry in the _pppp_kkkk_gggg_iiii_nnnn_ffff_oooo file is a line that establishes the value of a
  17.      parameter in the following form:
  18.  
  19.                      _P_A_R_A_M_====_""""_v_a_l_u_e_""""
  20.  
  21.      There is no required order in which the parameters must be specified
  22.      within the file.  Each parameter is described below.  Only fields marked
  23.      with an asterisk are mandatory.
  24.  
  25.      _P_K_G*            Abbreviation for the package being installed, generally
  26.                      three characters in length (for example, _dddd_iiii_rrrr or _pppp_kkkk_gggg).
  27.                      All characters in the abbreviation must be alphanumeric
  28.                      and the first may not be numeric.  The abbreviation is
  29.                      limited to a maximum length of nine characters.  _iiii_nnnn_ssss_tttt_aaaa_llll_llll,
  30.                      _nnnn_eeee_wwww, and _aaaa_llll_llll are reserved abbreviations.
  31.  
  32.      _N_A_M_E*           Text that specifies the package name (maximum length of
  33.                      256 ASCII characters).
  34.  
  35.      _A_R_C_H*           A comma-separated list of alphanumeric tokens that
  36.                      indicate the architecture (for example, _3333_BBBB_2222) associated
  37.                      with the package.  The _pppp_kkkk_gggg_mmmm_kkkk tool may be used to create
  38.                      or modify this value when actually building the package.
  39.                      The maximum length of a token is 16 characters and it
  40.                      cannot include a comma.
  41.  
  42.      _V_E_R_S_I_O_N*        Text that specifies the current version associated with
  43.                      the software package.  The maximum length is 256 ASCII
  44.                      characters and the first character cannot be a left
  45.                      parenthesis.  The _pppp_kkkk_gggg_mmmm_kkkk tool may be used to create or
  46.                      modify this value when actually building the package.
  47.  
  48.      _C_A_T_E_G_O_R_Y*       A comma-separated list of categories under which a
  49.                      package may be displayed.  Release 4 defines two
  50.                      categories: ``system'' and ``application.''  All packages
  51.                      must be assigned to one of these categories.  If you
  52.                      choose, you can also assign a package to one or more
  53.                      categories that you define.  Categories are case-
  54.                      insensitive and may contain only alphanumerics.  Each
  55.                      category is limited in length to 16 characters.
  56.  
  57.      _D_E_S_C            Text that describes the package (maximum length of 256
  58.                      ASCII characters).
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppkkkkggggiiiinnnnffffoooo((((4444))))                                                          ppppkkkkggggiiiinnnnffffoooo((((4444))))
  71.  
  72.  
  73.  
  74.      _V_E_N_D_O_R          Used to identify the vendor that holds the software
  75.                      copyright (maximum length of 256 ASCII characters).
  76.  
  77.      _H_O_T_L_I_N_E         Phone number and/or mailing address where further
  78.                      information may be received or bugs may be reported
  79.                      (maximum length of 256 ASCII characters).
  80.  
  81.      _E_M_A_I_L           An electronic address where further information is
  82.                      available or bugs may be reported (maximum length of 256
  83.                      ASCII characters).
  84.  
  85.      _V_S_T_O_C_K          The vendor stock number, if any, that identifies this
  86.                      product (maximum length of 256 ASCII characters).
  87.  
  88.      _C_L_A_S_S_E_S         A space-separated list of classes defined for a package.
  89.                      The order of the list determines the order in which the
  90.                      classes are installed.  Classes listed first will be
  91.                      installed first (on a media by media basis).  This
  92.                      parameter may be modified by the request script.
  93.  
  94.      _I_S_T_A_T_E_S         A list of allowable run states for package installation
  95.                      (for example, _""""_SSSS _ssss _1111_"""").
  96.  
  97.      _R_S_T_A_T_E_S         A list of allowable run states for package removal (for
  98.                      example, _""""_SSSS _ssss _1111_"""").
  99.  
  100.      _B_A_S_E_D_I_R         The pathname to a default directory where ``relocatable''
  101.                      files may be installed.  If _BBBB_AAAA_SSSS_EEEE_DDDD_IIII_RRRR is not specified and
  102.                      _b_a_s_e_d_i_r in the _aaaa_dddd_mmmm_iiii_nnnn(4) file
  103.                      (_////_vvvv_aaaa_rrrr_////_ssss_aaaa_dddd_mmmm_////_iiii_nnnn_ssss_tttt_aaaa_llll_llll_////_aaaa_dddd_mmmm_iiii_nnnn_////_dddd_eeee_ffff_aaaa_uuuu_llll_tttt) is set to _dddd_eeee_ffff_aaaa_uuuu_llll_tttt, the
  104.                      package is not considered relocatable.  In this case, if
  105.                      files have relative pathnames, package installation will
  106.                      fail.  An administrator can override the value of _BBBB_AAAA_SSSS_EEEE_DDDD_IIII_RRRR
  107.                      by setting _b_a_s_e_d_i_r in the _aaaa_dddd_mmmm_iiii_nnnn(4) file.
  108.  
  109.      _U_L_I_M_I_T          If set, this parameter is passed as an argument to the
  110.                      _uuuu_llll_iiii_mmmm_iiii_tttt command, which establishes the maximum size of a
  111.                      file during installation.
  112.  
  113.      _O_R_D_E_R           A list of classes defining the order in which they should
  114.                      be put on the medium.  Used by _pppp_kkkk_gggg_mmmm_kkkk in creating the
  115.                      package.  Classes not defined in this field are placed on
  116.                      the medium using the standard ordering procedures.
  117.  
  118.      _M_A_X_I_N_S_T         The maximum number of package instances that should be
  119.                      allowed on a machine at the same time.  By default, only
  120.                      one instance of a package is allowed.  This parameter
  121.                      must be set in order to have multiple instances of a
  122.                      package.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ppppkkkkggggiiiinnnnffffoooo((((4444))))                                                          ppppkkkkggggiiiinnnnffffoooo((((4444))))
  137.  
  138.  
  139.  
  140.      _P_S_T_A_M_P          Production stamp used to mark the _pppp_kkkk_gggg_mmmm_aaaa_pppp file on the
  141.                      output volumes.  Provides a means for distinguishing
  142.                      between production copies of a version if more than one
  143.                      is in use at a time.  If _PPPP_SSSS_TTTT_AAAA_MMMM_PPPP is not defined, the
  144.                      default is used.  The default consists of the UNIX system
  145.                      machine name followed by the string _""""_Y_Y_M_M_D_D_H_H_M_M_"""" (year,
  146.                      month, date, hour, minutes).
  147.  
  148.      _I_N_T_O_N_L_Y         Indicates that the package should only be installed
  149.                      interactively when set to any non-NULL value.
  150.  
  151.      _P_R_E_D_E_P_E_N_D       Used to maintain compatibility with pre-System V Release
  152.                      4 package dependency checking.  Pre-Release 4 dependency
  153.                      checks were based on whether or not the name file for the
  154.                      required package existed in the _////_vvvv_aaaa_rrrr_////_oooo_pppp_tttt_iiii_oooo_nnnn_ssss directory.
  155.                      This directory is not maintained for Release 4 packages
  156.                      since the _dddd_eeee_pppp_eeee_nnnn_dddd file is used for checking dependencies.
  157.                      However, entries can be created in this directory to
  158.                      maintain compatibility.  Setting the _PPPP_RRRR_EEEE_DDDD_EEEE_PPPP_EEEE_NNNN_DDDD parameter
  159.                      to _yyyy or _yyyy_eeee_ssss creates a _////_uuuu_ssss_rrrr_////_oooo_pppp_tttt_iiii_oooo_nnnn entry for the package.
  160.                      (Packages that are new for System V Release 4 do not need
  161.                      to use this parameter.)
  162.  
  163.      _S_E_R_I_A_L_N_U_M       A serial number, if any, that uniquely identifies this
  164.                      copy of the package (maximum length of 256 ASCII
  165.                      characters).
  166.  
  167. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  168.      Here is a sample _pppp_kkkk_gggg_iiii_nnnn_ffff_oooo:
  169.           _PPPP_KKKK_GGGG_====_""""_oooo_aaaa_mmmm_""""
  170.           _NNNN_AAAA_MMMM_EEEE_====_""""_OOOO_AAAA_MMMM _IIII_nnnn_ssss_tttt_aaaa_llll_llll_aaaa_tttt_iiii_oooo_nnnn _UUUU_tttt_iiii_llll_iiii_tttt_iiii_eeee_ssss_""""
  171.           _VVVV_EEEE_RRRR_SSSS_IIII_OOOO_NNNN_====_""""_3333_""""
  172.           _VVVV_EEEE_NNNN_DDDD_OOOO_RRRR_====_""""_AAAA_TTTT_&&&&_TTTT_""""
  173.           _HHHH_OOOO_TTTT_LLLL_IIII_NNNN_EEEE_====_""""_1111_----_8888_0000_0000_----_AAAA_TTTT_TTTT_----_BBBB_UUUU_GGGG_SSSS_""""
  174.           _EEEE_MMMM_AAAA_IIII_LLLL_====_""""_aaaa_tttt_tttt_uuuu_nnnn_iiii_xxxx_!!!!_oooo_llll_ssss_eeee_nnnn_""""
  175.           _VVVV_SSSS_TTTT_OOOO_CCCC_KKKK_====_""""_0000_1111_2222_2222_cccc_3333_ffff_5555_5555_6666_6666_""""
  176.           _CCCC_AAAA_TTTT_EEEE_GGGG_OOOO_RRRR_YYYY_====_""""_ssss_yyyy_ssss_tttt_eeee_mmmm_...._eeee_ssss_ssss_eeee_nnnn_tttt_iiii_aaaa_llll_""""
  177.           _IIII_SSSS_TTTT_AAAA_TTTT_EEEE_SSSS_====_""""_SSSS _2222_""""
  178.           _RRRR_SSSS_TTTT_AAAA_TTTT_EEEE_SSSS_====_""""_SSSS _2222_""""
  179.  
  180. NNNNOOOOTTTTEEEESSSS
  181.      Developers may define their own installation parameters by adding a
  182.      definition to this file.  A developer-defined parameter must begin with a
  183.      capital letter.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.